Device Management Service

Functions
IMPORTGOBI ULONG GOBICMAPI	SetPowerCallback (tFNPower pCallback)
IMPORTGOBI ULONG GOBICMAPI	SetActivationStatusCallback (tFNActivationStatus pCallback)
IMPORTGOBI ULONG GOBICMAPI	DMSUIMGetICCID (BYTE stringSize, CHAR *pString)
IMPORTGOBI ULONG GOBICMAPI	DMSUIMGetControlKeyStatus (ULONG id, ULONG *pStatus, ULONG *pVerifyRetriesLeft, ULONG *pUnblockRetriesLeft)
IMPORTGOBI ULONG GOBICMAPI	DMSUIMSetControlKeyProtection (ULONG id, ULONG status, CHAR *pValue, ULONG *pVerifyRetriesLeft)
IMPORTGOBI ULONG GOBICMAPI	DMSUIMUnblockControlKey (ULONG id, CHAR *pValue, ULONG *pUnblockRetriesLeft)
IMPORTGOBI ULONG GOBICMAPI	DMSUIMSetPINProtection (ULONG id, ULONG bEnable, CHAR *pValue, ULONG *pVerifyRetriesLeft, ULONG *pUnblockRetriesLeft)
IMPORTGOBI ULONG GOBICMAPI	DMSUIMVerifyPIN (ULONG id, CHAR *pValue, ULONG *pVerifyRetriesLeft, ULONG *pUnblockRetriesLeft)
IMPORTGOBI ULONG GOBICMAPI	DMSUIMUnblockPIN (ULONG id, CHAR *pPUKValue, CHAR *pNewValue, ULONG *pVerifyRetriesLeft, ULONG *pUnblockRetriesLeft)
IMPORTGOBI ULONG GOBICMAPI	DMSUIMChangePIN (ULONG id, CHAR *pOldValue, CHAR *pNewValue, ULONG *pVerifyRetriesLeft, ULONG *pUnblockRetriesLeft)
IMPORTGOBI ULONG GOBICMAPI	DMSUIMGetPINStatus (ULONG id, ULONG *pStatus, ULONG *pVerifyRetriesLeft, ULONG *pUnblockRetriesLeft)
IMPORTGOBI ULONG GOBICMAPI	GetHardwareRevision (BYTE stringSize, CHAR *pString)
IMPORTGOBI ULONG GOBICMAPI	GetPRLVersion (WORD *pPRLVersion)
IMPORTGOBI ULONG GOBICMAPI	GetERIFile (ULONG *pFileSize, BYTE *pFile)
IMPORTGOBI ULONG GOBICMAPI	ActivateAutomatic (CHAR *pActivationCode)
IMPORTGOBI ULONG GOBICMAPI	ActivateManual (CHAR *pSPC, WORD sid, CHAR *pMDN, CHAR *pMIN, ULONG prlSize, BYTE *pPRL, CHAR *pMNHA, CHAR *pMNAAA)
IMPORTGOBI ULONG GOBICMAPI	ResetToFactoryDefaults (CHAR *pSPC)
IMPORTGOBI ULONG GOBICMAPI	GetActivationState (ULONG *pActivationState)
IMPORTGOBI ULONG GOBICMAPI	SetPower (ULONG powerMode)
IMPORTGOBI ULONG GOBICMAPI	GetPower (ULONG *pPowerMode)
IMPORTGOBI ULONG GOBICMAPI	GetOfflineReason (ULONG *pReasonMask, ULONG *pbPlatform)
IMPORTGOBI ULONG GOBICMAPI	GetNetworkTime (ULONGLONG *pTimeCount, ULONG *pTimeSource)
IMPORTGOBI ULONG GOBICMAPI	ValidateSPC (CHAR *pSPC)
IMPORTGOBI ULONG GOBICMAPI	GetDeviceCapabilities (ULONG *pMaxTXChannelRate, ULONG *pMaxRXChannelRate, ULONG *pDataServiceCapability, ULONG *pSimCapability, ULONG *pRadioIfacesSize, BYTE *pRadioIfaces)
IMPORTGOBI ULONG GOBICMAPI	GetManufacturer (BYTE stringSize, CHAR *pString)
IMPORTGOBI ULONG GOBICMAPI	GetModelID (BYTE stringSize, CHAR *pString)
IMPORTGOBI ULONG GOBICMAPI	GetFirmwareRevision (BYTE stringSize, CHAR *pString)
IMPORTGOBI ULONG GOBICMAPI	GetFirmwareRevisions (BYTE amssSize, CHAR *pAMSSString, BYTE bootSize, CHAR *pBootString, BYTE priSize, CHAR *pPRIString)
IMPORTGOBI ULONG GOBICMAPI	GetFirmwareInfo (ULONG *pFirmwareID, ULONG *pTechnology, ULONG *pCarrier, ULONG *pRegion, ULONG *pGPSCapability)
IMPORTGOBI ULONG GOBICMAPI	GetVoiceNumber (BYTE voiceNumberSize, CHAR *pVoiceNumber, BYTE minSize, CHAR *pMIN)
IMPORTGOBI ULONG GOBICMAPI	GetIMSI (BYTE stringSize, CHAR *pString)
IMPORTGOBI ULONG GOBICMAPI	GetSerialNumbers (BYTE esnSize, CHAR *pESNString, BYTE imeiSize, CHAR *pIMEIString, BYTE meidSize, CHAR *pMEIDString)
IMPORTGOBI ULONG GOBIAPI	GetStoredImages (ULONG *pImageListSize, BYTE *pImageList)
IMPORTGOBI ULONG GOBIAPI	SetImagesPreference (ULONG imageListSize, BYTE *pImageList, ULONG bForceDownload, BYTE modemIndex, ULONG *pImageTypesSize, BYTE *pImageTypes)
IMPORTGOBI ULONG GOBIAPI	GetImagesPreference (ULONG *pImageListSize, BYTE *pImageList)

Detailed Description

Function Documentation

IMPORTGOBI ULONG GOBICMAPI ActivateAutomatic

(

CHAR *

pActivationCode

)

This function requests the device to perform automatic service activation QMI_DMS_ACTIVATE_AUTOMATIC_MSG = 0x0032

Parameters

pActivationCode

[ I ] - Activation code (maximum string length of 12)

Returns

See GobiErrorCodes.h

IMPORTGOBI ULONG GOBICMAPI ActivateManual	(	CHAR *	pSPC,
		WORD	sid,
		CHAR *	pMDN,
		CHAR *	pMIN,
		ULONG	prlSize,
		BYTE *	pPRL,
		CHAR *	pMNHA,
		CHAR *	pMNAAA
	)

This function requests the device perform manual service activation, after a successful request the device is then asked to reset QMI_DMS_ACTIVATE_MANUAL_MSG = 0x0033

Parameters

pSPC	[ I ] - NULL terminated string representing the six digit service programming code
sid	[ I ] - System identification number
pMDN	[ I ] - Mobile Directory Number string
pMIN	[ I ] - Mobile Identification Number string
prlSize	[ I ] - (Optional) Size of PRL file array
pPRL	[ I ] - (Optional) The PRL file contents
pMNHA	[ I ] - (Optional) MN-HA string
pMNAAA	[ I ] - (Optional) MN-AAA string

Returns

See GobiErrorCodes.h

IMPORTGOBI ULONG GOBICMAPI DMSUIMChangePIN	(	ULONG	id,
		CHAR *	pOldValue,
		CHAR *	pNewValue,
		ULONG *	pVerifyRetriesLeft,
		ULONG *	pUnblockRetriesLeft
	)

This function change the PIN value QMI_DMS_UIM_CHANGE_PIN_MSG = 0x002A

Parameters

id	[ I ] - PIN ID (1/2)
pOldValue	[ I ] - Old PIN value of the PIN to change
pNewValue	[ I ] - New PIN value of the PIN to change
pVerifyRetriesLeft	[ O ] - Upon operational failure this will indicate the number of retries left, after which the PIN will be blocked (0xFFFFFFFF = unknown)
pUnblockRetriesLeft	[ O ] - Upon operational failure this will indicate the number of unblock retries left, after which the PIN will be permanently blocked, i.e. UIM is unusable (0xFFFFFFFF = unknown)

Returns

See GobiErrorCodes.h

IMPORTGOBI ULONG GOBICMAPI DMSUIMGetControlKeyStatus	(	ULONG	id,
		ULONG *	pStatus,
		ULONG *	pVerifyRetriesLeft,
		ULONG *	pUnblockRetriesLeft
	)

This function returns the status of the specified facility control key QMI_DMS_UIM_GET_CK_STATUS_MSG = 0x0040

Parameters

id	[ I ] - Facility ID
pStatus	[ O ] - Control key status
pVerifyRetriesLeft	[ O ] - The number of retries left, after which the control key will be blocked
pUnblockRetriesLeft	[ O ] - The number of unblock retries left, after which the control key will be permanently blocked

Returns

See GobiErrorCodes.h

IMPORTGOBI ULONG GOBICMAPI DMSUIMGetICCID	(	BYTE	stringSize,
		CHAR *	pString
	)

This function returns the UIM ICCID QMI_DMS_UIM_GET_ICCID_MSG = 0x003C

Parameters

stringSize	[ I ] - The maximum number of characters (including NULL terminator) that the string array can contain
pString	[ O ] - NULL terminated string

Returns

See GobiErrorCodes.h

IMPORTGOBI ULONG GOBICMAPI DMSUIMGetPINStatus	(	ULONG	id,
		ULONG *	pStatus,
		ULONG *	pVerifyRetriesLeft,
		ULONG *	pUnblockRetriesLeft
	)

This function returns the status of the pin QMI_DMS_UIM_GET_PIN_STATUS_MSG = 0x002B

Parameters

id	[ I ] - PIN ID (1/2)
idpStatus	[ O ] - PIN status (0xFFFFFFFF = unknown)
idpVerifyRetriesLeft	[ O ] - The number of retries left, after which the PIN will be blocked (0xFFFFFFFF = unknown)
idpUnblockRetriesLeft	[ O ] - The number of unblock retries left, after which the PIN will be permanently blocked, i.e. UIM is unusable (0xFFFFFFFF = unknown)

IMPORTGOBI ULONG GOBICMAPI DMSUIMSetControlKeyProtection	(	ULONG	id,
		ULONG	status,
		CHAR *	pValue,
		ULONG *	pVerifyRetriesLeft
	)

This function changes the specified facility control key QMI_DMS_UIM_SET_CK_PROTECTION_MSG = 0x0041

Parameters

id	[ I ] - Facility ID
status	[ I ] - Control key status
pValue	[ I ] - Control key de-personalization string
pVerifyRetriesLeft	[ O ] - Upon operational failure this will indicate the number of retries left, after which the control key will be blocked

Returns

See GobiErrorCodes.h

IMPORTGOBI ULONG GOBICMAPI DMSUIMSetPINProtection	(	ULONG	id,
		ULONG	bEnable,
		CHAR *	pValue,
		ULONG *	pVerifyRetriesLeft,
		ULONG *	pUnblockRetriesLeft
	)

This function enables or disables protection of UIM contents by a given PIN QMI_DMS_UIM_SET_PIN_PROTECTION_MSG = 0x0027

Parameters

id	[ I ] - PIN ID (1/2)
bEnable	[ I ] - Enable/disable PIN protection (0 = disable)?
pValue	[ I ] - PIN value of the PIN to be enabled/disabled
pVerifyRetriesLeft	[ O ] - Upon operational failure this will indicate the number of retries left, after which the PIN will be blocked (0xFFFFFFFF = unknown)
pUnblockRetriesLeft	[ O ] - Upon operational failure this will indicate the number of unblock retries left, after which the PIN will be permanently blocked, i.e. UIM is unusable (0xFFFFFFFF = unknown)

Returns

See GobiErrorCodes.h

IMPORTGOBI ULONG GOBICMAPI DMSUIMUnblockControlKey	(	ULONG	id,
		CHAR *	pValue,
		ULONG *	pUnblockRetriesLeft
	)

This function unblocks the specified facility control key QMI_DMS_UIM_UNBLOCK_CK_MSG = 0x0042

Parameters

id	[ I ] - Facility ID
pValue	[ I ] - Control key de-personalization string
pUnblockRetriesLeft	[ O ] - The number of unblock retries left, after which the control key will be permanently blocked

Returns

See GobiErrorCodes.h

IMPORTGOBI ULONG GOBICMAPI DMSUIMUnblockPIN	(	ULONG	id,
		CHAR *	pPUKValue,
		CHAR *	pNewValue,
		ULONG *	pVerifyRetriesLeft,
		ULONG *	pUnblockRetriesLeft
	)

DMSUIMUnblockPIN

This function unblocks a blocked PIN QMI_DMS_UIM_UNBLOCK_PIN_MSG = 0x0029

Parameters

id	[ I ] - PIN ID (1/2)
pPUKValue	[ I ] - PUK value of the PIN to unblock
pNewValue	[ I ] - New PIN value of the PIN to unblock
pVerifyRetriesLeft	[ O ] - Upon operational failure this will indicate the number of retries left, after which the PIN will be blocked (0xFFFFFFFF = unknown)
pUnblockRetriesLeft	[ O ] - Upon operational failure this will indicate the number of unblock retries left, after which the PIN will be permanently blocked, i.e. UIM is unusable (0xFFFFFFFF = unknown)

Returns

See GobiErrorCodes.h

IMPORTGOBI ULONG GOBICMAPI DMSUIMVerifyPIN	(	ULONG	id,
		CHAR *	pValue,
		ULONG *	pVerifyRetriesLeft,
		ULONG *	pUnblockRetriesLeft
	)

This function verifies the PIN before accessing the UIM contents QMI_DMS_UIM_VERIFY_PIN_MSG = 0x0028

Parameters

id	[ I ] - PIN ID (1/2)
pValue	[ I ] - PIN value of the PIN to verify
pVerifyRetriesLeft	[ O ] - Upon operational failure this will indicate the number of retries left, after which the PIN will be blocked (0xFFFFFFFF = unknown)
pUnblockRetriesLeft	[ O ] - Upon operational failure this will indicate the number of unblock retries left, after which the PIN will be permanently blocked, i.e. UIM is unusable (0xFFFFFFFF = unknown)

Returns

See GobiErrorCodes.h

IMPORTGOBI ULONG GOBICMAPI GetActivationState

(

ULONG *

pActivationState

)

This function returns the device activation state QMI_DMS_GET_ACTIVATION_STATE_MSG = 0x0031

Parameters

pActivationState

[ O ] - Service activation state

Returns

See GobiErrorCodes.h

IMPORTGOBI ULONG GOBICMAPI GetDeviceCapabilities	(	ULONG *	pMaxTXChannelRate,
		ULONG *	pMaxRXChannelRate,
		ULONG *	pDataServiceCapability,
		ULONG *	pSimCapability,
		ULONG *	pRadioIfacesSize,
		BYTE *	pRadioIfaces
	)

This function gets device capabilities QMI_DMS_GET_DEVICE_CAP_MSG = 0x0020

Parameters

pMaxTXChannelRate	[ O ] - Maximum transmission rate (bps)
pMaxRXChannelRate	[ O ] - Maximum reception rate (bps)
pDataServiceCapability	[ O ] - CS/PS data service capability
pSimCapability	[ O ] - Device SIM support
pRadioIfacesSize	[I/O] - Upon input the maximum number of elements that the radio interfaces can contain. Upon successful output the actual number of elements in the radio interface array
pRadioIfaces	[ O ] - The radio interface array

Returns

See GobiErrorCodes.h

IMPORTGOBI ULONG GOBICMAPI GetERIFile	(	ULONG *	pFileSize,
		BYTE *	pFile
	)

This command returns the ERI file that is stored in EFS on the device QMI_DMS_READ_ERI_FILE_MSG = 0x0039

Parameters

pFileSize	[I/O] - Upon input the maximum number of bytes that the file contents array can contain. Upon successful output the actual number of bytes written to the file contents array
pFile	[ O ] - The file contents

Returns

See GobiErrorCodes.h

IMPORTGOBI ULONG GOBICMAPI GetFirmwareInfo	(	ULONG *	pFirmwareID,
		ULONG *	pTechnology,
		ULONG *	pCarrier,
		ULONG *	pRegion,
		ULONG *	pGPSCapability
	)

Returns image information obtained from the current device firmware QMI_DMS_GET_DEVICE_REV_ID_MSG = 0x0023

Parameters

pFirmwareID	[ O ] - Firmware ID obtained from the firmware image
pTechnology	[ O ] - Technology (0xFFFFFFFF if unknown)
pCarrier	[ O ] - Carrier (0xFFFFFFFF if unknown)
pRegion	[ O ] - Region (0xFFFFFFFF if unknown)
pGPSCapability	[ O ] - GPS capability (0xFFFFFFFF if unknown)

Returns

See GobiErrorCodes.h

IMPORTGOBI ULONG GOBICMAPI GetFirmwareRevision	(	BYTE	stringSize,
		CHAR *	pString
	)

This function returns the device firmware revision

Parameters

stringSize	[ I ] - The maximum number of characters (including NULL terminator) that the string array can contain
pString	[ O ] - NULL terminated string

Returns

See GobiErrorCodes.h

IMPORTGOBI ULONG GOBICMAPI GetFirmwareRevisions	(	BYTE	amssSize,
		CHAR *	pAMSSString,
		BYTE	bootSize,
		CHAR *	pBootString,
		BYTE	priSize,
		CHAR *	pPRIString
	)

This function returns the device firmware (AMSS, boot, and PRI) revisions QMI_DMS_GET_DEVICE_REV_ID_MSG = 0x0023

Parameters

amssSize	[ I ] - The maximum number of characters (including NULL terminator) that the AMSS string array can contain
pAMSSString	[ O ] - NULL terminated AMSS revision string
bootSize	[ I ] - The maximum number of characters (including NULL terminator) that the boot string array can contain
pBootString	[ O ] - NULL terminated boot code revision string
priSize	[ I ] - The maximum number of characters (including NULL terminator) that the PRI string array can contain
pPRIString	[ O ] - NULL terminated PRI revision string

Returns

See GobiErrorCodes.h

IMPORTGOBI ULONG GOBICMAPI GetHardwareRevision	(	BYTE	stringSize,
		CHAR *	pString
	)

This function returns the device hardware revision QMI_DMS_GET_DEVICE_HARDWARE_REV_MSG = 0x002C;

Parameters

stringSize	[ I ] - The maximum number of characters (including NULL terminator) that the string array can contain
pString	[ O ] - NULL terminated string

Returns

See GobiErrorCodes.h

IMPORTGOBI ULONG GOBIAPI GetImagesPreference	(	ULONG *	pImageListSize,
		BYTE *	pImageList
	)

This function gets the current images preference QMI_DMS_GET_FIRMWARE_PREF_MSG = 0x0047;

Parameters

pCallbackpImageListSize	[I/O] - Upon input the size in BYTEs of the image list array. Upon success the actual number of BYTEs copied to the image list array
pImageList	[ O ] - The image info list array

Returns

See GobiErrorCodes.h

IMPORTGOBI ULONG GOBICMAPI GetIMSI	(	BYTE	stringSize,
		CHAR *	pString
	)

This function returns the device IMSI

Parameters

stringSize	[ I ] - The maximum number of characters (including NULL terminator) that the string array can contain
pString	[ O ] - NULL terminated string

Returns

See GobiErrorCodes.h

IMPORTGOBI ULONG GOBICMAPI GetManufacturer	(	BYTE	stringSize,
		CHAR *	pString
	)

This function returns the device manufacturer name QMI_DMS_GET_DEVICE_MFR_MSG = 0x0021

Parameters

stringSize	[ I ] - The maximum number of characters (including NULL terminator) that the string array can contain
pString	[ O ] - NULL terminated string

Returns

See GobiErrorCodes.h

IMPORTGOBI ULONG GOBICMAPI GetModelID	(	BYTE	stringSize,
		CHAR *	pString
	)

This function returns the device model ID QMI_DMS_GET_DEVICE_MODEL_ID_MSG = 0x0022

Parameters

stringSize	[ I ] - The maximum number of characters (including NULL terminator) that the string array can contain
pString	[ O ] - NULL terminated string

Returns

See GobiErrorCodes.h

IMPORTGOBI ULONG GOBICMAPI GetNetworkTime	(	ULONGLONG *	pTimeCount,
		ULONG *	pTimeSource
	)

This function returns the current time of the device QMI_DMS_VALIDATE_SERVICE_PROGRAMMING_CODE_MSG = 0x003B

Parameters

pTimeCount	[ O ] - Count of 1.25ms that have elapsed from the start of GPS time (Jan 6, 1980)
pTimeSource	[ O ] - Source of the timestamp

Returns

See GobiErrorCodes.h

IMPORTGOBI ULONG GOBICMAPI GetOfflineReason	(	ULONG *	pReasonMask,
		ULONG *	pbPlatform
	)

This function returns the reason why the operating mode of the device is currently offline QMI_DMS_GET_OPERATING_MODE_MSG = 0x002D

Parameters

pReasonMask	[ O ] - Bitmask of offline reasons
pbPlatform	[ O ] - Offline due to being platform retricted?

Returns

See GobiErrorCodes.h

IMPORTGOBI ULONG GOBICMAPI GetPower

(

ULONG *

pPowerMode

)

This function returns the operating mode of the device QMI_DMS_GET_OPERATING_MODE_MSG = 0x002D

Parameters

pPowerMode

[ O ] - Current operating mode

Returns

See GobiErrorCodes.h

IMPORTGOBI ULONG GOBICMAPI GetPRLVersion

(

WORD *

pPRLVersion

)

This function returns the version of the active Preferred Roaming List (PRL) in use by the device QMI_DMS_GET_PRL_VER_MSG = 0x0030

Parameters

pPRLVersion

[ O ] - The PRL version number

Returns

See GobiErrorCodes.h

IMPORTGOBI ULONG GOBICMAPI GetSerialNumbers	(	BYTE	esnSize,
		CHAR *	pESNString,
		BYTE	imeiSize,
		CHAR *	pIMEIString,
		BYTE	meidSize,
		CHAR *	pMEIDString
	)

This command returns all serial numbers assigned to the device QMI_DMS_GET_DEVICE_SERIAL_NUMBERS_MSG = 0x0025

Parameters

esnSize	[ I ] - The maximum number of characters (including NULL terminator) that the ESN array can contain
pESNString	[ O ] - ESN string (empty string returned when ESN is not supported/programmed)
imeiSize	[ I ] - The maximum number of characters (including NULL terminator) that the IMEI array can contain
pIMEIString	[ O ] - IMEI string (empty string returned when IMEI is not supported/programmed)
meidSize	[ I ] - The maximum number of characters (including NULL terminator) that the MEID array can contain
pMEIDString	[ O ] - MEID string (empty string returned when MEID is not supported/programmed)

Returns

See GobiErrorCodes.h

IMPORTGOBI ULONG GOBIAPI GetStoredImages	(	ULONG *	pImageListSize,
		BYTE *	pImageList
	)

This function gets the list of images stored on the device QMI_DMS_LIST_STORED_IMAGES_MSG = 0x0049

Parameters

pImageListSize	[I/O] - Upon input the size in BYTEs of the image list array. Upon success the actual number of BYTEs copied to the image list array
pImageList	[ O ] - The image info list array

Returns

See GobiErrorCodes.h

IMPORTGOBI ULONG GOBICMAPI GetVoiceNumber	(	BYTE	voiceNumberSize,
		CHAR *	pVoiceNumber,
		BYTE	minSize,
		CHAR *	pMIN
	)

This function returns the voice number in use by the device QMI_DMS_GET_MSISDN_MSG = 0x0024

Parameters

voiceNumberSize	[ I ] - The maximum number of characters (including NULL terminator) that the voice number array can contain
pVoiceNumber	[ O ] - Voice number (MDN or ISDN) string
minSize	[ I ] - The maximum number of characters (including NULL terminator) that the MIN array can contain
pMIN	[ O ] - MIN string (empty string returned when MIN is not supported/programmed)

Returns

See GobiErrorCodes.h

IMPORTGOBI ULONG GOBICMAPI ResetToFactoryDefaults

(

CHAR *

pSPC

)

This function requests the device reset configuration to factory defaults, after a successful request the device is then asked to reset QMI_DMS_RESTORE_FACTORY_DEFAULTS_MSG = 0x003A

Parameters

pSPC	[ I ] - NULL terminated string representing the six digit service programming code

Returns

See GobiErrorCodes.h

IMPORTGOBI ULONG GOBICMAPI SetActivationStatusCallback

(

tFNActivationStatus

pCallback

)

This function enables/disables the activation status callback function with QMI_DMS_SET_EVENT_REPORT 0x0001 TLV 0x013

Parameters

pCallback

[ I ] - Callback function (0 = disable)

Returns

See GobiErrorCodes.h

IMPORTGOBI ULONG GOBIAPI SetImagesPreference	(	ULONG	imageListSize,
		BYTE *	pImageList,
		ULONG	bForceDownload,
		BYTE	modemIndex,
		ULONG *	pImageTypesSize,
		BYTE *	pImageTypes
	)

This function sets the current images preference QMI_DMS_SET_FIRMWARE_PREF_MSG = 0x0048

Parameters

imageListSize	[ I ] - The size in BYTEs of the image list array
pImageList	[ I ] - The image list array
bForceDownload	[ I ] - Force device to download images from host?
modemIndex	[ I ] - Desired storage index for downloaded modem image
pImageTypesSize	[I/O] - Upon input the maximum number of elements that the download image types array can contain. Upon successful output the actual number of elements in the download image types array
pImageTypes	[ O ] - The download image types array

Returns

See GobiErrorCodes.h

IMPORTGOBI ULONG GOBICMAPI SetPower

(

ULONG

powerMode

)

This function sets the operating mode of the device QMI_DMS_SET_OPERATING_MODE_MSG = 0x002E

Parameters

powerMode

[ I ] - Selected operating mode

Returns

See GobiErrorCodes.h

IMPORTGOBI ULONG GOBICMAPI SetPowerCallback

(

tFNPower

pCallback

)

Enable/disable power operating mode callback function QMI_DMS_SET_EVENT_REPORT_REQ 0x0001 TLV 0x10

Parameters

pCallback

[ I ] - Callback function

Returns

See GobiErrorCodes.h

IMPORTGOBI ULONG GOBICMAPI ValidateSPC

(

CHAR *

pSPC

)

This function validates the service programming code QMI_DMS_VALIDATE_SERVICE_PROGRAMMING_CODE_MSG = 0x003B

pSPC [ I ] - Six digit service programming code

Returns

See GobiErrorCodes.h